Pull Request

Commander has long supported options at both the program level and in subcommands, but using both at once was a little subtle for both the author and the end-user.

Problem

In the Help you can't see all the options at once for a subcommand when the program has global options.

See: #1078 #1689

The global options poll has continued accumulating votes for displaying global options after the poll was closed. #1551 (comment)

Solution

Add help configuration to show the global options. This is off by default so can go in a feature version without changing behaviour of executing programs.

The global options are included in the padding calculations and are optional sorted.

The global options are shown in a separate section. This is the layout that was shown in #1551 (comment)).

Using the updated example file:

$ node examples/global-options-nested.js sub --help
Usage: global-options-nested sub [options]

Options:
  -l, --local
  -h, --help    display help for command

Global Options:
  -g, --global

ChangeLog

• added: showGlobalOptions to .configureHelp{}